home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / BANDR.z / BANDR
Encoding:
Text File  |  1998-10-30  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ____BBBBAAAANNNNDDDDRRRR((((3333FFFF))))                                                          ____BBBBAAAANNNNDDDDRRRR((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      BANDR, SBANDR   -  EISPACK routine.  This subroutine reduces a REAL
  10.      SYMMETRIC BAND matrix to a symmetric tridiagonal matrix using and
  11.      optionally accumulating orthogonal similarity transformations.
  12.  
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSYYYYSSSS
  15.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee  bbbbaaaannnnddddrrrr((((nnnnmmmm,,,, nnnn,,,, mmmmbbbb,,,, aaaa,,,, dddd,,,, eeee,,,, eeee2222,,,, mmmmaaaattttzzzz,,,, zzzz))))
  16.           iiiinnnntttteeeeggggeeeerrrr          nnnnmmmm,,,, nnnn,,,, mmmmbbbb,,,, zzzz
  17.           ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn aaaa((((nnnnmmmm,,,,mmmmbbbb)))),,,, dddd((((nnnn)))),,,, eeee((((nnnn)))),,,, eeee2222((((nnnn)))),,,, zzzz((((nnnnmmmm,,,,nnnn))))
  18.           llllooooggggiiiiccccaaaallll          mmmmaaaattttzzzz
  19.  
  20.           ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssbbbbaaaannnnddddrrrr((((nnnnmmmm,,,, nnnn,,,, mmmmbbbb,,,, aaaa,,,, dddd,,,, eeee,,,, eeee2222,,,, mmmmaaaattttzzzz,,,, zzzz))))
  21.           iiiinnnntttteeeeggggeeeerrrr          nnnnmmmm,,,, nnnn,,,, mmmmbbbb,,,, zzzz
  22.           rrrreeeeaaaallll             aaaa((((nnnnmmmm,,,,mmmmbbbb)))),,,, dddd((((nnnn)))),,,, eeee((((nnnn)))),,,, eeee2222((((nnnn)))),,,, zzzz((((nnnnmmmm,,,,nnnn))))
  23.           llllooooggggiiiiccccaaaallll          mmmmaaaattttzzzz
  24.  
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      On INPUT
  29.  
  30.      NNNNMMMM must be set to the row dimension of two-dimensional array parameters
  31.      as declared in the calling program dimension statement.
  32.  
  33.      NNNN is the order of the matrix.
  34.  
  35.      MMMMBBBB is the (half) band width of the matrix, defined as the number of
  36.      adjacent diagonals, including the principal diagonal, required to specify
  37.      the non-zero portion of the lower triangle of the matrix.
  38.  
  39.      AAAA contains the lower triangle of the symmetric band input matrix stored
  40.      as an N by MB array.  Its lowest subdiagonal is stored in the last N+1-MB
  41.      positions of the first column, its next subdiagonal in the last N+2-MB
  42.      positions of the second column, further subdiagonals similarly, and
  43.      finally its principal diagonal in the N positions of the last column.
  44.      Contents of storages not part of the matrix are arbitrary.
  45.  
  46.      MMMMAAAATTTTZZZZ should be set to .TRUE. if the transformation matrix is to be
  47.      accumulated, and to .FALSE. otherwise.  On OUTPUT
  48.  
  49.      AAAA has been destroyed, except for its last two columns which contain a
  50.      copy of the tridiagonal matrix.
  51.  
  52.      DDDD contains the diagonal elements of the tridiagonal matrix.
  53.  
  54.      EEEE contains the subdiagonal elements of the tridiagonal matrix in its last
  55.      N-1 positions.  E(1) is set to zero.
  56.  
  57.      EEEE2222 contains the squares of the corresponding elements of E. E2 may
  58.      coincide with E if the squares are not needed.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ____BBBBAAAANNNNDDDDRRRR((((3333FFFF))))                                                          ____BBBBAAAANNNNDDDDRRRR((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      ZZZZ contains the orthogonal transformation matrix produced in the reduction
  75.      if MATZ has been set to .TRUE.  Otherwise, Z is not referenced.
  76.      Questions and comments should be directed to B. S. Garbow, Applied
  77.      Mathematics Division, ARGONNE NATIONAL LABORATORY
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.